Release 10.1A: OpenEdge Development:
Progress Dynamics Advanced Development

Paging methods

This section contains information about paging methods.

assignPageProperty

Use the assignPageProperty procedure to assign a property value to all the objects on the current page. If you must set a property on a page that is not the current page, you can reset the CurrentPage property to the page you want, run the procedure, and then set it back, as shown:

Procedure assignPageProperty: Params: INPUT PARAMETER pcProp AS CHARACTER INPUT PARAMETER pcValue AS CHARACTER. Candidate for calling

deletePage

Use the deletePage procedure to delete all the objects on the specified page, as shown:

Procedure deletePage: Params: INPUT PARAMETER piPageNum AS INTEGER. Candidate for: calling

hidePage

Use the hidePage procedure to hide all the objects on a page. Normally your code does not call this procedure directly, since the selectPage procedure automatically hides whatever was on the previous page, as shown:

Procedure hidePage: Params: INPUT PARAMETER piPageNum AS INTEGER.

initPages

Use the initPages procedure to initialize pages simultaneously. Normally pages are initialized when they are first viewed. The first page to be viewed is stored in the StartPage property, and all the objects on the page are started, initialized, and viewed when the window is run. Sometimes, however, you must initialize other pages at the same time in order to be able to create links to and from them, or to have objects prepared to receive data from objects on other pages. In this case, you can call initPages and pass it a list of the pages to be initialized on startup of the window, as shown:

Procedure initPages: Params: INPUT PARAMETER pcPageList AS CHARACTER. Candidate for: calling

viewPage

Use the viewPage procedure when you want another page to be displayed without hiding the objects on the current page. Normally this would be when the new page is in fact a different window, which you want to have appear in addition to the window containing the folder. Otherwise, when you want to hide one page and see another, run selectPage, as shown:

Procedure viewPage: Params: INPUT PARAMETER piPageNum AS INTEGER. Candidate for: calling

selectPage

Use the selectPage support procedure when you want to switch the folder display from one page to another. It hides the objects on the current page, resets the current page to the INPUT parameter, and views the objects on that new page, as shown:

Procedure selectPage: Params: INPUT PARAMETER piPageNum AS INTEGER. Candidate for: calling

targetPage

Use the targetPage INTEGER support function to return the page that a specified object is on. Pass in the procedure handle of the object, as shown:

Function targetPage() Params: phObject AS HANDLE. Returns: INTEGER